.. _NeurEco Tabular:

NeurEco Tabular
=====================

For **Tabular** templates both input and output features are sets of scalar parameters.

**Tabular** is proposed with:

•	Graphical user interface
•	Python API
•	Command line interface



.. include:: Tabular License.rst

There are currently three tabular templates.

Tabular Regression
------------------------

This template addresses most of engineer's needs. It is used to create neural network models where the outputs are continuous variables, corresponding to the modeling of physical phenomena. NeurEco will create a regression predictive model that approximate the underlying process by a function :math:`Y = f(X)`, where :math:`X` is the input and :math:`Y` is the output of the model.

For a quickstart tutorial, see :std:ref:`NeurEco tabular regression quickstart tutorial`

For a full documentation, see :std:ref:`Regression`

Tabular Classification 
----------------------------

This template is used to create neural network models for classification problems where the output describes the belonging of the input to one of the few possible classes.

Tabular Regression meets most engineering needs. For example, a binary response indicating that a system is defective occurs when its response exceeds a given threshold of stress, temperature or/and number of cycles... To solve most classification problems, it is better to post-process the output of a regression model by applying a threshold. This approach can result in better classification because the targeted physical value is rich with information contrary to the classification poor binary target.

We propose this Tabular Classification template because it is not always possible to reformulate the problem into a regression problem or to get the corresponding physical data.

For Tabular Classification the model is still :math:`Y = f(X)`, but :math:`Y` is a binary one-hot encoded vector of at least two components: one of the components of :math:`Y` is set to one, while all the other components are set to zero. If the :math:`i^{th}` component is set to one, it means that the corresponding :math:`X` belong to class :math:`i`.

For a quickstart tutorial, see :std:ref:`NeurEco tabular classification quickstart tutorial`

For a full documentation, see :std:ref:`Classification`

Tabular Compression
-----------------------------
This template is a powerful tool to reduce dimensionality of :math:`X`, when :math:`X` is a large vector. This reduces the size of data and it complexity.

In this case we create two neural networks, a compressor :math:`C` and a decompressor :math:`D`. The input vector :math:`X` is compressed to :math:`x`, such that :math:`x=C(X)`, where the dimension of :math:`x` is small in comparison with the dimension of :math:`X`.  Moreover, it is possible to reconstruct :math:`X` using :math:`X=D(x)`.

The main application of this compression process is to use :math:`x` instead of :math:`X` as the input to a regression model.

For a quickstart tutorial, see :std:ref:`NeurEco tabular compression quickstart tutorial`

For a full documentation, see :std:ref:`Compression`